Skip to main content
Search for Skills similar to the text provided
curl --request GET \
  --url https://{tenant_name}.{region}.techwolf.ai/skills/search \
  --header 'Authorization: Bearer <token>'
[
  {
    "skill": "Machine Learning",
    "skill_id": "a3903505-eb84-42dc-a79f-5e7b1fe897b7",
    "domain": "Data Science"
  }
]

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
query
string
required
Maximum length: 100
Example:

"Machine%20le"

​
limit
integer
default:10

The maximal number of results returned.

Required range: x >= 1
Example:

10

​
search_method
enum<string>
default:autocomplete

Indicates how Skills are searched for with the given query.

Available options:
autocomplete
Example:

"autocomplete"

​
domain_namespace
enum<string>
default:techwolf

The Domain namespace determines the Domains the Skills will be mapped to. Using techwolf will map them to the default TechWolf domains. Using taxonomy will map them to the custom Domains defined in your Taxonomy. Using adaptive will map the Skills to the Domains in the custom Taxonomy if there is one present, otherwise it will fall back to the default Techwolf Domains.

Available options:
techwolf,
taxonomy,
adaptive
​
external_vendor
enum<string>

The external vendor vocabulary in which you want to search for Skills. This will only work for vendors that are activated on your tenant. When specified, the query parameter domain_namespace will not work, and Domains will not be returned in the response, as they are not supported on external vendor Skills.

Available options:
workday,
sap_attribute_library
Example:

"workday"

​
properties
object

Filter skills by their properties. Use the format properties[property_name]=value to filter skills that have a specific property with a specific value. For example, properties[sap_status]=active will only return skills that have the sap_status property set to active.

Available properties:

  • sap_status: Status of the Skill in the SAP Attribute Library (possible values: active, inactive)
​
vocab_language
enum<string>
default:en_uk

The display language in which the Skill names are provided. If not specified, the default language (en_uk) will be used. The en language is an alias for en_uk.

Available options:
en,
en_uk,
en_us,
de,
fr,
nl

Response

OK

​
skill
string
required

The name of the Skill. If an external vendor is specified in the query parameter external_vendor, the Skill name will be the external vendor's Skill name.

Minimum length: 1
Example:

"Machine Learning"

​
skill_id
string<uuid>
required

The universally unique ID of the Skill, consisting of alphanumeric characters, hyphens and underscores. If an external vendor is specified in the query parameter external_vendor, the Skill ID will be the external vendor's Skill ID.

Required string length: 1 - 100
Example:

"a3903505-eb84-42dc-a79f-5e7b1fe897b7"

​
domain
string

The Domain of the Skill. Not present if an external vendor is specified in the query parameter external_vendor.

Minimum length: 1
Example:

"Data Science"

⌘I